home *** CD-ROM | disk | FTP | other *** search
/ Windows 32-Bit Gallery / Windows 32-bit Gallery.iso / win95 / winbatch / meter.tx_ < prev    next >
Encoding:
Text File  |  1996-11-20  |  1.7 KB  |  33 lines
  1.   METER.WBT is an example of how to meter the usage of an application on a
  2.   network.  This is a generic routine, which must be CALL'ed from your main
  3.   WinBatch program (if you are CALLing METER.WBT from a compiled WinBatch
  4.   executable, you must first encode METER.WBT using the WinBatch compiler).
  5.  
  6.   Usage: METER appname function [username]
  7.  
  8.     appname  = root name of the executable program being metered.
  9.     function = either '+' (increase usage) or '-' (decrease usage).
  10.     username = user name (optional).
  11.  
  12.   If 'username' is specified, then METER.WBT will count multiple accesses by
  13.   the specified user as only a single usage.  This can be helpful to handle
  14.   the problem of users whose systems crash, or who otherwise abnormally end
  15.   a session, and who later try to re-access the application they were using.
  16.  
  17.   Return value:
  18.  
  19.     If 'function' is '+', and METER.WBT determines that the user is allowed
  20.     to access the specified application, then the variable 'meterok' is set
  21.     to @YES (1).  Otherwise, the variable 'meterok' is set to @NO (0).
  22.  
  23.   For each application you wish to meter, you will need a separate INI file
  24.   named 'appname.INI'.  METER.WBT will create this INI file if it does not
  25.   already exist, but you will need to enter an appropriate value for
  26.   "Maximum Users" before you can use it.  METER.WBT will also create a file
  27.   for each application named 'appname.LOK', which prevents more than one
  28.   user at a time from accessing the INI file.  These files are stored in the
  29.   directory specified by the variable 'meterdir' (see the top of METER.WBT);
  30.   this should be a central directory to which all users have write access.
  31.  
  32.   Use this program at your own risk.  No warranty is expressed or implied.
  33.